<?php
/*
 **************************************************************************************************
 *	Register the required plugins for this theme
 **************************************************************************************************
*/
function prototype_theme_register_required_plugins() {

	// required keys are name, slug and required,
	// if the source is NOT from the .org repo, then source is also required
	$plugins = array(
		// include a plugin pre-packaged with a theme
		/*
		array(
			'name'					=> 'Jetpack',		// the plugin name
			'slug'					=> 'jetpack',		// the plugin slug (typically the folder name)
			'source'				=> get_stylesheet_directory() . '/plugins/tgm-plugin-activation/jetpack.zip', // the plugin source
			'required'				=> true,			// if false, the plugin is only 'recommended' instead of required
			'version'				=> '2.5',			// e.g. 1.0.0. if set, the active plugin must be this version or higher, otherwise a notice is presented
			'force_activation'		=> false,			// if true, plugin is activated upon theme activation and cannot be deactivated until theme switch
			'force_deactivation'	=> false			// if true, plugin is deactivated upon theme switch, useful for theme-specific plugins
		),
		*/
		// include a plugin from the wordpress plugin repository
		array(
			'name'		=> 'Jetpack',
			'slug'		=> 'jetpack',
			'required'	=> false,
		),
		array(
			'name'		=> 'Debug This',
			'slug'		=> 'debug-this',
			'required'	=> false,
		),
	);

	// change this to your theme text domain, used for internationalising strings
	$theme_text_domain = TEXTDOMAIN;

	// array of configuration settings
	$config = array(
		'domain'			=> $theme_text_domain,			// text domain - likely want to be the same as your theme
		'default_path'		=> '',							// default absolute path to pre-packaged plugins
		'parent_menu_slug'	=> 'themes.php',				// default parent menu slug
		'parent_url_slug'	=> 'themes.php',				// default parent URL slug
		'menu'				=> 'install-required-plugins',	// menu slug
		'has_notices'		=> true,						// show admin notices or not
		'is_automatic'		=> false,						// automatically activate plugins after installation or not
		'message'			=> '',							// message to output right before the plugins table

		'strings'			=> array(
			'page_title'						=> __( 'Install Required Plugins', $theme_text_domain ),
			'menu_title'						=> __( 'Install Plugins', $theme_text_domain ),
			'installing'						=> __( 'Installing Plugin: %s', $theme_text_domain ), // %1$s = plugin name
			'oops'								=> __( 'Something went wrong with the plugin API.', $theme_text_domain ),
			'notice_can_install_required'		=> _n_noop( 'This theme requires the following plugin: %1$s.', 'This theme requires the following plugins: %1$s.' ), // %1$s = plugin name(s)
			'notice_can_install_recommended'	=> _n_noop( 'This theme recommends the following plugin: %1$s.', 'This theme recommends the following plugins: %1$s.' ), // %1$s = plugin name(s)
			'notice_cannot_install'				=> _n_noop( 'Sorry, but you do not have the correct permissions to install the %s plugin. Contact the administrator of this site for help on getting the plugin installed.', 'Sorry, but you do not have the correct permissions to install the %s plugins. Contact the administrator of this site for help on getting the plugins installed.' ), // %1$s = plugin name(s)
			'notice_can_activate_required'		=> _n_noop( 'The following required plugin is currently inactive: %1$s.', 'The following required plugins are currently inactive: %1$s.' ), // %1$s = plugin name(s)
			'notice_can_activate_recommended'	=> _n_noop( 'The following recommended plugin is currently inactive: %1$s.', 'The following recommended plugins are currently inactive: %1$s.' ), // %1$s = plugin name(s)
			'notice_cannot_activate'			=> _n_noop( 'Sorry, but you do not have the correct permissions to activate the %s plugin. Contact the administrator of this site for help on getting the plugin activated.', 'Sorry, but you do not have the correct permissions to activate the %s plugins. Contact the administrator of this site for help on getting the plugins activated.' ), // %1$s = plugin name(s)
			'notice_ask_to_update'				=> _n_noop( 'The following plugin needs to be updated to its latest version to ensure maximum compatibility with this theme: %1$s.', 'The following plugins need to be updated to their latest version to ensure maximum compatibility with this theme: %1$s.' ), // %1$s = plugin name(s)
			'notice_cannot_update'				=> _n_noop( 'Sorry, but you do not have the correct permissions to update the %s plugin. Contact the administrator of this site for help on getting the plugin updated.', 'Sorry, but you do not have the correct permissions to update the %s plugins. Contact the administrator of this site for help on getting the plugins updated.' ), // %1$s = plugin name(s)
			'install_link'						=> _n_noop( 'Begin installing plugin', 'Begin installing plugins' ),
			'activate_link'						=> _n_noop( 'Activate installed plugin', 'Activate installed plugins' ),
			'return'							=> __( 'Return to Required Plugins Installer', $theme_text_domain ),
			'plugin_activated'					=> __( 'Plugin activated successfully.', $theme_text_domain ),
			'complete'							=> __( 'All plugins installed and activated successfully. %s', $theme_text_domain ) // %1$s = dashboard link
		)
	);

	tgmpa( $plugins, $config );

}

add_action( 'tgmpa_register', 'prototype_theme_register_required_plugins' );